<?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content=
    "application/xhtml+xml; charset=iso-8859-1" />
    <title>
      Mutt-1.13.4
    </title>
    <link rel="stylesheet" type="text/css" href="../stylesheets/lfs.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.78.1" />
    <link rel="stylesheet" href="../stylesheets/lfs-print.css" type=
    "text/css" media="print" />
  </head>
  <body class="blfs" id="blfs-2020-04-02">
    <div class="navheader">
      <h4>
        Beyond Linux<sup>�</sup> From Scratch <span class="phrase">(System
        V</span> Edition) - Version 2020-04-02
      </h4>
      <h3>
        Chapter&nbsp;19.&nbsp;Mail/News Clients
      </h3>
      <ul>
        <li class="prev">
          <a accesskey="p" href="mailx.html" title="mailx-12.5">Prev</a>
          <p>
            mailx-12.5
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="procmail.html" title=
          "Procmail-3.22">Next</a>
          <p>
            Procmail-3.22
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="mailnews.html" title=
          "Chapter&nbsp;19.&nbsp;Mail/News Clients">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 2020-04-02">
          Home</a>
        </li>
      </ul>
    </div>
    <div class="sect1" lang="en" xml:lang="en">
      <h1 class="sect1">
        <a id="mutt" name="mutt"></a>Mutt-1.13.4
      </h1>
      <div class="package" lang="en" xml:lang="en">
        <h2 class="sect2">
          Introduction to Mutt
        </h2>
        <p>
          The <span class="application">Mutt</span> package contains a Mail
          User Agent. This is useful for reading, writing, replying to,
          saving, and deleting your email.
        </p>
        <p>
          This package is known to build and work properly using an LFS-9.1
          platform.
        </p>
        <h3>
          Package Information
        </h3>
        <div class="itemizedlist">
          <ul class="compact">
            <li class="listitem">
              <p>
                Download (HTTP): <a class="ulink" href=
                "https://bitbucket.org/mutt/mutt/downloads/mutt-1.13.4.tar.gz">
                https://bitbucket.org/mutt/mutt/downloads/mutt-1.13.4.tar.gz</a>
              </p>
            </li>
            <li class="listitem">
              <p>
                Download (FTP): <a class="ulink" href=
                "ftp://ftp.mutt.org/pub/mutt/mutt-1.13.4.tar.gz">ftp://ftp.mutt.org/pub/mutt/mutt-1.13.4.tar.gz</a>
              </p>
            </li>
            <li class="listitem">
              <p>
                Download MD5 sum: 8f08d01bb6379ce4f803560db3f1bc65
              </p>
            </li>
            <li class="listitem">
              <p>
                Download size: 4.7 MB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated disk space required: 48 MB (add 6MB for the PDF
                manual)
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated build time: 0.3 SBU (add 0.2 SBU for the PDF
                manual)
              </p>
            </li>
          </ul>
        </div>
        <h3>
          Mutt Dependencies
        </h3>
        <h4>
          Optional
        </h4>
        <p class="optional">
          <a class="xref" href="../general/aspell.html" title=
          "Aspell-0.60.8">Aspell-0.60.8</a>, <a class="xref" href=
          "../postlfs/cyrus-sasl.html" title="Cyrus SASL-2.1.27">Cyrus
          SASL-2.1.27</a>, <a class="xref" href="../general/gdb.html" title=
          "GDB-9.1">GDB-9.1</a>, <a class="xref" href="../postlfs/gnupg.html"
          title="GnuPG-2.2.20">GnuPG-2.2.20</a>, <a class="xref" href=
          "../postlfs/gnutls.html" title="GnuTLS-3.6.13">GnuTLS-3.6.13</a>,
          <a class="xref" href="../postlfs/gpgme.html" title=
          "GPGME-1.13.1">GPGME-1.13.1</a>, <a class="xref" href=
          "../general/libidn.html" title="libidn-1.35">libidn-1.35</a>,
          <a class="xref" href="../postlfs/mitkrb.html" title=
          "MIT Kerberos V5-1.18">MIT Kerberos V5-1.18</a>, an <a class="xref"
          href="../server/mail.html" title=
          "Chapter&nbsp;21.&nbsp;Mail Server Software">MTA</a> (that provides
          a <span class="command"><strong>sendmail</strong></span> command),
          <a class="xref" href="../general/slang.html" title=
          "slang-2.3.2">slang-2.3.2</a>, <a class="xref" href=
          "../server/sqlite.html" title="SQLite-3.31.1">SQLite-3.31.1</a>,
          <a class="ulink" href=
          "http://www.citi.umich.edu/projects/nfsv4/linux/">libgssapi</a>,
          <a class="ulink" href=
          "http://mixmaster.sourceforge.net/">Mixmaster</a>, <a class="ulink"
          href="http://fallabs.com/qdbm/">QDBM</a> or <a class="ulink" href=
          "http://fallabs.com/tokyocabinet/">Tokyo Cabinet</a>
        </p>
        <h4>
          Optional (To Regenerate HTML Documentation)
        </h4>
        <p class="optional">
          <a class="xref" href="../general/libxslt.html" title=
          "libxslt-1.1.34">libxslt-1.1.34</a> and either <a class="xref"
          href="lynx.html" title="Lynx-2.8.9rel.1">Lynx-2.8.9rel.1</a>,
          <a class="ulink" href="http://w3m.sourceforge.net/">W3m</a>, or
          <a class="ulink" href="http://elinks.or.cz">ELinks</a>
        </p>
        <h4>
          Optional (To Generate PDF Manual)
        </h4>
        <p class="optional">
          <a class="xref" href="../pst/docbook-dsssl.html" title=
          "docbook-dsssl-1.79">docbook-dsssl-1.79</a>, <a class="xref" href=
          "../pst/openjade.html" title="OpenJade-1.3.2">OpenJade-1.3.2</a>,
          and <a class="xref" href="../pst/texlive.html" title=
          "texlive-20190410-source">texlive-20190410</a> (or <a class="xref"
          href="../pst/tl-installer.html" title=
          "install-tl-unx">install-tl-unx</a> with <span class=
          "command"><strong>pdfjadetex</strong></span> installed)
        </p>
        <p class="usernotes">
          User Notes: <a class="ulink" href=
          "http://wiki.linuxfromscratch.org/blfs/wiki/mutt">http://wiki.linuxfromscratch.org/blfs/wiki/mutt</a>
        </p>
      </div>
      <div class="installation" lang="en" xml:lang="en">
        <h2 class="sect2">
          Installation of Mutt
        </h2>
        <p>
          <span class="application">Mutt</span> requires a group named
          <code class="systemitem">mail</code>. You can add this group, if it
          does not exist, with this command:
        </p>
        <pre class="root">
<kbd class="command">groupadd -g 34 mail</kbd>
</pre>
        <p>
          If you did not install an <a class="xref" href=
          "../server/mail.html" title=
          "Chapter&nbsp;21.&nbsp;Mail Server Software">MTA</a>, you need to
          modify the ownership of <code class="filename">/var/mail</code>
          with this command:
        </p>
        <pre class="root">
<kbd class="command">chgrp -v mail /var/mail</kbd>
</pre>
        <p>
          <span class="application">Mutt</span> will rebuild the html
          documentation if <span class="application">libxslt</span> is
          present, then use that to update the text manual - even if none of
          the specified browsers are present. That will create an empty text
          file, so we will save the shipped file.
        </p>
        <p>
          Install <span class="application">Mutt</span> by running the
          following commands:
        </p>
        <pre class="userinput">
<kbd class="command">cp -v doc/manual.txt{,.shipped} &amp;&amp;
./configure --prefix=/usr                           \
            --sysconfdir=/etc                       \
            --with-docdir=/usr/share/doc/mutt-1.13.4 \
            --with-ssl                              \
            --enable-external-dotlock               \
            --enable-pop                            \
            --enable-imap                           \
            --enable-hcache                         \
            --enable-sidebar                        &amp;&amp;
make</kbd>
</pre>
        <p>
          To generate the PDF manual with <a class="xref" href=
          "../pst/texlive.html" title=
          "texlive-20190410-source">texlive-20190410</a>, run the following
          command:
        </p>
        <pre class="userinput">
<kbd class="command">make -C doc manual.pdf</kbd>
</pre>
        <p>
          This package does not come with a test suite.
        </p>
        <p>
          Now, as the <code class="systemitem">root</code> user:
        </p>
        <pre class="root">
<kbd class="command">make install &amp;&amp;
test -s doc/manual.txt ||
  install -v -m644 doc/manual.txt.shipped \
  /usr/share/doc/mutt-1.13.4/manual.txt</kbd>
</pre>
        <p>
          If you generated the PDF manual, install it by issuing the
          following command as the <code class="systemitem">root</code> user:
        </p>
        <pre class="root">
<kbd class="command">install -v -m644 doc/manual.pdf \
    /usr/share/doc/mutt-1.13.4</kbd>
</pre>
        <div class="admon note">
          <img alt="[Note]" src="../images/note.png" />
          <h3>
            Note
          </h3>
          <p>
            If you used a DESTDIR method to only install to a temporary
            location as a regular user (as part of a package menagement
            process), you will need to run the following as the <code class=
            "systemitem">root</code> user after completing the real install:
          </p>
          <pre class="userinput">
<kbd class="command">chown root:mail /usr/bin/mutt_dotlock &amp;&amp;
chmod -v 2755 /usr/bin/mutt_dotlock</kbd>
</pre>
          <p>
            An info file is now installed, so you will also need to recreate
            the <code class="filename">/usr/share/info/dir</code> as
            described when <span class="application">Texinfo</span> was
            installed in LFS.
          </p>
        </div>
      </div>
      <div class="commands" lang="en" xml:lang="en">
        <h2 class="sect2">
          Command Explanations
        </h2>
        <p>
          <em class="parameter"><code>--enable-external-dotlock</code></em>:
          In some circumstances the mutt-dotlock program is not created. This
          switch ensures it is always created.
        </p>
        <p>
          <em class="parameter"><code>--enable-pop</code></em>: This switch
          enables POP3 support.
        </p>
        <p>
          <em class="parameter"><code>--enable-imap</code></em>: This switch
          enables IMAP support.
        </p>
        <p>
          <em class="parameter"><code>--enable-hcache</code></em>: This
          switch enables header caching.
        </p>
        <p>
          <em class="parameter"><code>--enable-sidebar</code></em>: This
          switch enables support for the sidebar (a list of mailboxes). It is
          off by default, but can be turned on by <span class=
          "command"><strong>:set sidebar_visible</strong></span> in mutt (and
          off again with ':unset'), or it can be enabled in <code class=
          "filename">~/.muttrc</code>.
        </p>
        <p>
          <em class="parameter"><code>--with-ssl</code></em>: This parameter
          adds SSL/TLS support from openssl in POP3/IMAP/SMTP.
        </p>
        <p>
          <code class="option">--enable-autocrypt --with-sqlite3</code>:
          These two switches add support for passive protection against data
          collection, using gnupg and gpgme (gpgme is enabled by autocrypt).
          See <a class="ulink" href=
          "http://www.mutt.org/doc/manual/#autocryptdoc">The Manual</a>.
        </p>
        <p>
          <code class="option">--enable-gpgme</code>: This switch enables GPG
          support through the GPGME package. Use this switch if you want GPG
          support in Mutt.
        </p>
        <p>
          <code class="option">--enable-smtp</code>: This switch enables SMTP
          relay support.
        </p>
        <p>
          <code class="option">--with-idn2</code>: Use this parameter if both
          libidn and libidn2 have been installed, and you wish to use libidn2
          here.
        </p>
        <p>
          <code class="option">--with-sasl</code>: This parameter adds
          authentication support from <a class="xref" href=
          "../postlfs/cyrus-sasl.html" title="Cyrus SASL-2.1.27">Cyrus
          SASL-2.1.27</a> in POP3/IMAP/SMTP if they are enabled. Depending on
          the server configuration, this may not be needed for POP3 or IMAP.
          However, it is needed for SMTP authentication.
        </p>
        <p>
          <span class="command"><strong>test -s doc/manual.txt || install -v
          -m644 doc/manual.txt.shipped ...</strong></span>: if the text
          manual is now empty (<span class="application">libxslt</span> is
          installed, but without any of the specified text browsers), install
          the saved copy <span class="emphasis"><em>after</em></span> running
          'make install' <span class="emphasis"><em>(which would itself empty
          manual.txt if the shipped file had already been copied
          back)</em></span>.
        </p>
      </div>
      <div class="configuration" lang="en" xml:lang="en">
        <h2 class="sect2">
          Configuring Mutt
        </h2>
        <div class="sect3" lang="en" xml:lang="en">
          <h3 class="sect3">
            <a id="mutt-config" name="mutt-config"></a>
          </h3>
          <h4 class="title">
            <a id="mutt-config" name="mutt-config"></a>Config Files
          </h4>
          <p>
            <code class="filename">/etc/Muttrc</code>, <code class=
            "filename">~/.muttrc</code>, <code class=
            "filename">/etc/mime.types</code>, and <code class=
            "filename">~/.mime.types</code>
          </p>
        </div>
        <div class="sect3" lang="en" xml:lang="en">
          <h3 class="sect3"></h3>
          <h4 class="title">
            <a id="idm140006438502416" name=
            "idm140006438502416"></a>Configuration Information
          </h4>
          <p>
            No changes in these files are necessary to begin using
            <span class="application">Mutt</span>. When you are ready to make
            changes, the man page for <code class="filename">muttrc</code> is
            a good starting place.
          </p>
          <p>
            In order to utilize <span class="application">GnuPG</span>, use
            the following command:
          </p>
          <pre class="userinput">
<kbd class=
"command">cat /usr/share/doc/mutt-1.13.4/samples/gpg.rc &gt;&gt; ~/.muttrc</kbd>
</pre>
        </div>
      </div>
      <div class="content" lang="en" xml:lang="en">
        <h2 class="sect2">
          Contents
        </h2>
        <div class="segmentedlist">
          <div class="seglistitem">
            <div class="seg">
              <strong class="segtitle">Installed Programs:</strong>
              <span class="segbody">flea, mutt, mutt_dotlock, muttbug,
              pgpewrap, pgpring, and smime_keys</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Libraries:</strong>
              <span class="segbody">None</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Directories:</strong>
              <span class="segbody">/usr/share/doc/mutt-1.13.4</span>
            </div>
          </div>
        </div>
        <div class="variablelist">
          <h3>
            Short Descriptions
          </h3>
          <table border="0" class="variablelist">
            <colgroup>
              <col align="left" valign="top" />
              <col />
            </colgroup>
            <tbody>
              <tr>
                <td>
                  <p>
                    <a id="flea" name="flea"></a><span class=
                    "term"><span class=
                    "command"><strong>flea</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a script showing where to report bugs.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="mutt-prog" name="mutt-prog"></a><span class=
                    "term"><span class=
                    "command"><strong>mutt</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a Mail User Agent (MUA) which enables you to read,
                    write and delete your email.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="mutt_dotlock" name="mutt_dotlock"></a><span class=
                    "term"><span class=
                    "command"><strong>mutt_dotlock</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    implements the mail spool file lock.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="muttbug" name="muttbug"></a><span class=
                    "term"><span class=
                    "command"><strong>muttbug</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a script identical to <span class=
                    "command"><strong>flea</strong></span>.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="pgpewrap" name="pgpewrap"></a><span class=
                    "term"><span class=
                    "command"><strong>pgpewrap</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    prepares a command line for the <a class="xref" href=
                    "../postlfs/gnupg.html" title=
                    "GnuPG-2.2.20">GnuPG-2.2.20</a> utilities.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="pgpring" name="pgpring"></a><span class=
                    "term"><span class=
                    "command"><strong>pgpring</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a key ring dumper for <a class="ulink" href=
                    "http://www.pgp.com/">PGP</a>. It is not needed for
                    <a class="xref" href="../postlfs/gnupg.html" title=
                    "GnuPG-2.2.20">GnuPG-2.2.20</a>.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="smime_keys" name="smime_keys"></a><span class=
                    "term"><span class=
                    "command"><strong>smime_keys</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    manages a keystore for S/MIME certificates.
                  </p>
                </td>
              </tr>
            </tbody>
          </table>
        </div>
      </div>
      <p class="updated">
        Last updated on 2020-03-23 16:46:15 -0500
      </p>
    </div>
    <div class="navfooter">
      <ul>
        <li class="prev">
          <a accesskey="p" href="mailx.html" title="mailx-12.5">Prev</a>
          <p>
            mailx-12.5
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="procmail.html" title=
          "Procmail-3.22">Next</a>
          <p>
            Procmail-3.22
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="mailnews.html" title=
          "Chapter&nbsp;19.&nbsp;Mail/News Clients">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 2020-04-02">
          Home</a>
        </li>
      </ul>
    </div>
  </body>
</html>
